home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / englis~1.lzh / TURBOASS.TXT < prev   
Encoding:
Text File  |  1986-08-25  |  23.3 KB  |  970 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                 TurboAss
  9.               ©1989 Σ-soft
  10.          Markus Fritze & Sören Hellwig
  11.  
  12.  
  13.                Version 1.7
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.           Markus Fritze, Sören Hellwig
  55.                 March 1990
  56.     Imported and translated by the United Coding Alliance
  57.              
  58.  
  59.  
  60.        
  61.  
  62.  
  63. 1.1            Turbo-Ass Introduction            1
  64.  
  65.  
  66.  
  67.  
  68. 1.  General
  69.  
  70. 1.1  Introduction
  71.  
  72. After long back and forth we (Σ-Soft) decided to market our Assembler
  73. package under the Shareware concept. Prior to that the Assembler was
  74. sold commercially through OMIKRON-Software under the name OMIKRON-
  75. Assembler. However, the Shareware version is an expanded and entlarged
  76. version of the old OMIKRON Assembler. It contains less mistakes, 
  77. additional and improved features and is faster. In the package included
  78. are the Debugger (of course), the Bugadoo (before OMIKRON Debugger).
  79. Consequently every User can enjoy the fast and powerful Assembler 
  80. aswell as the Debugger. Especially since there are so many Programming
  81. Languages that are sold as Shareware or as PD, there aren't any 
  82. reasonably good Assemblers around. 
  83.  
  84. THE COMPANY OMIKRON SOFTWARE BARES NO RELATION WITH THIS ASSEMBLER 
  85. PACKAGE. Σ-SOFT IS THE ONLY OWNER AND HAS THE FULL RIGHTS FOR THIS 
  86. ASSEMBLER AND DEBUGGER!
  87.  
  88. This Document is not thought to be an Introduction but a presentation of
  89. the Turbo-Assembler. The complete manual of 254 Pages can be obtained
  90. from the Authors. If needed it is possible to consult issues 11/89 and 
  91. 12/89 of "ST-Magazin" for further information. The Assembler and the
  92. Debugger are topics of the Referencecard in the above issues.
  93.  
  94. Supplement:
  95.  
  96. Compared to the Manual many features are not included in the README file
  97. it is just to much.......(Markus)
  98.  
  99.  
  100. 1.2 Turbo-Assembler Features
  101.  
  102.    - Simple and thought-out Operation (Very User Friendly).
  103.  
  104.    - The Assembler translates approx. 1.3 Million lines/minute.
  105.  
  106.    - Syntax-Check DURING Input. Partly Semantic-Check! Typing mistakes
  107.      aswell as double use of Symbolnames are shown directly during
  108.      Input.
  109.  
  110.    - Many powerful Editor Functions such as: Search for Text, Replace 
  111.      Text, "Turn-In" of partial programs (like GFA-Basic 3.0) and many
  112.      more features.
  113.  
  114.    - Fantastic combinational work between the Debugger and Assembler. In
  115.      crash cases of a program in the Debugger the Assembler auto-
  116.      matically computes the Crash Address into a line number.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124. 1.1             Turbo-Ass Introduction            2
  125.  
  126.  
  127.  
  128.     
  129.  
  130.    - Own Keyboard and Screendriver => Even in the most hardest Crash
  131.      conditions the Assembler and Debugger are still functioning.
  132.  
  133.    - No Macros!!!
  134.  
  135.    - and many more things....
  136.  
  137.  
  138. 1.3  What is Shareware?
  139.  
  140.    - Everyone can/should copy Turbo-Ass! However, ALL Files should
  141.      be copied and be included on the disk.
  142.  
  143.    - If you like the Assembler please send us 50 DM (German Marks). This
  144.      has advantages for all parties involved:
  145.  
  146.      For us:
  147.      - We don't work totally for free (It took 3 Years to develop the 
  148.        package).
  149.  
  150.      For the User:
  151.      - He/She will receive a 254 page strong manual.
  152.  
  153.      - He/She receives the latest version with a customized Serialnumber
  154.  
  155.      - First Update is for free.
  156.  
  157.      - If Errors are encountered a Error-Free version is shipped.
  158.  
  159.      - If an problems/errors arise you could contact us for assistance.
  160.  
  161.      - When Registering, every User that will state his Serialnumber
  162.        we will award 10DM (Max. of 10 times, we don't want to finance
  163.        PD institutions). The money is thought to be as a "Reward" for
  164.        the demonstration and coping of the product.
  165.  
  166.      - Note: If anybody is registrering, and the Serialnumber of the
  167.        previous owner is stated the User that this Serialnumber belongs
  168.        to will receive 10DM.
  169.  
  170. If you want to accept this offer please contact:
  171.          Markus Fritze
  172.          Birkhahnkamp 38
  173.          2000 Norderstedt 1
  174.          Tel: 040/5223955
  175.          (from 6 PM including the weekend (please not before 
  176.           11 AM)
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. 1.1             Turbo-Ass Introduction
  186.  
  187.  
  188.        Bank Code Number: 20069111, Norderstedter Bank
  189.        Account Number  : 407860
  190.  
  191. When ordering please have some patients with the delivery. Even thought 
  192. I hope to complete all Mail the same day it is possible that we run out
  193. of manuals or new updates are in order, thus this takes sometimes a bit
  194. longer (If you don't receive it after 2-3 Weeks an Inquiry can be send).
  195. I APPOLOGIZE FOR ANY INCONVENIENCE THAT MAY ARISE BECAUSE OF IT.
  196.  
  197.  
  198.  
  199. 1.4  Hardware Requirements
  200.  
  201. ATARI ST with 512k of memory whereas with 1Mb and above it is possible
  202. to hold the Assembler and Debugger at the same time in RAM, which on
  203. its part makes it possible to produce effective Debugging. The high
  204. Resolution Screen is recommended but the Medium one works also very well
  205. (High is better for the eyes). Turbo-Ass works on Colour monitor aswell
  206. as Monochrome Monitors.
  207.  
  208.  
  209. 1.5  Installation
  210.  
  211. Copy  TURBOASS.PRG,  TURBOASS.CFG,   TURBOASS.DAT,   BUGABOO.PRG   and
  212. CALL. PRG to a disk or into a Folder. That's it.
  213.  
  214.  
  215. 1.6  About the Authors
  216.  
  217. Sören Hellwig and Markus Fritze are currently 21 and 22 Years old and
  218. currently studying computer science at the University of Wedel near 
  219. Hamburg. This is the one of the reasons why we ask for a little bit of
  220. patient. Unfortunately our studies are first priority. We will answer
  221. any letter that include Int. coupons. Mail without international coupons
  222. will be answered only in exceptional cases (Registration doesn't require
  223. international coupons!).
  224.  
  225.  
  226.  
  227. 1.7  Copyright 
  228.  
  229. All rights reserved by Σ-soft. Every person has the right to copy the
  230. Assembler. It is also allowed to upload it to Bulletin Board Systems.
  231. The Turbo-Ass and the complete manual where put together with extereme
  232. professionalism and care. Unfortunately misktakes are hard to exclude 
  233. therefore we want to bring to your attention that Σ-soft is not liable    
  234. for any mishafs caused by the software, hardware or mistakes in the 
  235. manual. We also don't take any responsibility if somebody accuses us
  236. that as a result of Turbo-Ass his whole Harddrive was erases and Source-
  237. coded with a value of a couple million Mark where destroyed. 
  238. Note: Use at your own risk as to the quality and performance of the 
  239.       programs is with you. Should the program prove defective, you 
  240.       assume the entire cost of all necessary repair or corrections
  241.       (This is the same for all Software Companies).
  242.  
  243.  
  244.  
  245.  
  246. 1.1            Turbo-Ass Introduction            4
  247.  
  248.  
  249.  
  250.  
  251. 2  The Assembler
  252.  
  253.  
  254. 2.1  User Guide for Turbo-Assembler
  255.  
  256. The usage is GEM independent which means it was programmed from scratch.
  257. It has the advantage of making Turbo-Ass faster aswell as pretty save to
  258. crashes. Additional to that a few handy features where implemented. 
  259. Nevertheless, GEM should not be overlooked. By pressing the ALT button 
  260. with the small letters in the buttons it causes the same effect as to 
  261. click the buttons with the Mouse.
  262.  
  263.  
  264. 2.2  The Mouse in Turbo-Assembler
  265.  
  266. There are many things that can be done with the Mouse, however only the 
  267. usage with the Assembler is explained:
  268.  
  269. Sourcecode:
  270. Left Mouse Button: 
  271. Simple Click: Set Cursor
  272. Long Click: Mark Block (with scrolling)
  273. Double Click: Jump to Definition of the clicked Symbol
  274.  
  275. Right Mouse Button:
  276. Simple Click: Scroll Sourcecode (click only at the edge!)
  277. Double Click: Equation to be taken over
  278.  
  279.  
  280. 2.3  The Editor
  281.  
  282. Every inputed line is automatically checked for Syntax Errors and 
  283. Semantics. If the line contains no mistakes a formated output of 
  284. this line occurs. In case of an inputed mistakes the type of 
  285. mistake is shown on top (Statusline).
  286.  
  287.  
  288. 2.4  Special Features
  289.  
  290. "Absolute Short" as an Adresstypy is directly supported. A ".w" must
  291. be included after the Address.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307. 1.1            Turbo-Ass Introduction            5
  308.  
  309.  
  310.  
  311.  
  312.  
  313. Line-A Routines can be entered with the "LINEA #Number" format. The
  314. Assembler converts non-Motorola inputs into the Motorola standart.
  315.  
  316.  
  317. 2.5  Optimization
  318.  
  319. Included:
  320. Absolute long  -> relative
  321. Relative       -> relative short
  322. Absolute long  -> PC-relative
  323. MOVE.L #xx,A0  -> LEA xx,A0 (if following that PC-relative anything 
  324.                  gives)
  325. MOVE.L #xx,-(SP)->PEA xx,A0 (if following that PC-relative anything
  326.                  gives)
  327. Additional to that typical jumps are found for a few C Compilers
  328. (Example: 2 BRA on top of each other where the second BRA is never 
  329. jumped to). If the Assembler finds any cases where Optimization is
  330. possible the Assembler will show a Button called "To Adjust" after
  331. it. The Assembler which as a result will optimize the Source code.
  332. It is also possible to reverse-optimize, if this may seem of any 
  333. help.
  334.  
  335.  
  336. 2.6  Formulas
  337.  
  338. Everything standart is accepted such as:
  339.      + - * / ! (LOG.NOT) ~  (NOT or EOR)
  340.      <<  (SHL  >> (SHR) | (OR) & (AND)
  341.      also comparisons are supported
  342.  
  343. Number Systems supported:
  344.      Decimal     : . or nothing
  345.      Hexadecimal : $
  346.      Binary     : %
  347.      ASCII     : " or '
  348.  
  349. Internal variables are ^^DATE (GEMDOS-DATE),  ^^TIME (GEMDOS-TIME)
  350. *  (act. PC),  ^^RSCOUNT (act. value of RS-Counter) and  ^^SYMTAB (<>0,
  351. during production of the Symbol table).
  352. Symbols can be 23 character long where ALL characters are ellowed. Vowel
  353. mutation is also supported >126 (also supported). Exception ASCII 255.
  354.  
  355.  
  356. 2.7  Keyboard Commands
  357.  
  358. Cursorkeys, Backspace, e.t.c. and as usuall CTRL-Y, CTRL-B....
  359. like Tempus (Text-Editor)
  360. CTRL-D          doubles the Cursorline.
  361. CTRL-M/ALT-M  makes the moving of a line possible.
  362. CTRL-W          changes the Numberbase under the Cursor.
  363. CTRL-U          markes all characters with warnings where
  364.  
  365.  
  366.  
  367.  
  368. 1.1             Turbo-Ass Introduction            6
  369.  
  370.  
  371.  
  372.  
  373. a Symbol is defined that is not used anywhere. This is fantastic to
  374. find unused Subprograms!
  375. ALT-Numeric Keyboard   Same as in MS-DOS, gives ASCII back.
  376. ESC+Letter           Abbreviation for a command.
  377. CTRL-ESC           Start Keyboard Macro followed by the defined
  378.                character. All followed Keys are set (not the
  379.                Mouse). Finish the procedure with ALT-ESC. Keys
  380.                can be cleared by pressing CTRL-ESC, Key and
  381.                finally with ALT-ESC (follow the consequantional
  382.                order).
  383.  
  384.  
  385. 2.8   Editor Footnotes
  386.  
  387. With the option "Load..." it is possible to load plain ASCII-Text. Upon
  388. loading the ASCII-Text is converted into the Turbo-Ass Format which will
  389. be indicated. The options "Search Symbol" and "Replace Symbol" allow 
  390. the programmer to search and replace Symbols. The possibility of wild-
  391. card search is possible such as all Symbols that start with the letter
  392. "M" (Mask:"M*") without finding every Move-Instruction (such as all 
  393. ASCII Editors). "Jump to line" allows of jumping to the Symbol 
  394. definition (Input: "M*"). The dialog boxes in the "Setting" Menu are
  395. parly selfexplanatory and the rest is either unimportant or to 
  396. complicated to explain in this document.
  397.  
  398.  
  399. 2.9  The Assembler
  400.  
  401. Called with F1. If any errors occur during the Assembly the Assembler
  402. markes all lines containing them. After the Assembly it is possible to
  403. jump from one error to another through the CTRL-J or Shift-CTRL-J. The
  404. Assembler saves the errors, cursor position e.t.c. with the source code!
  405.  
  406. In the Dialogbox after (!) the Assembly it is possible to set a few 
  407. extra options:
  408.  
  409.    - Should the Symboltable be attached to the program (or passed on to 
  410.      the Debugger)?
  411.    - The saving of the Assembled program in different formats is also
  412.      possible:
  413.  
  414.    Debugger: Jump into the Debugger with Program passing (No Memory)
  415.    Standart: Save Program (normal)
  416.    Datas   : Develop Data-Lines (for OMIKRON Basic)
  417.    Absolute: Develop a program for a specific Adress (Example: EPROM)
  418.    BASIC   : Special Format for Basic
  419.    OMINLINE: Produce INLINE-Line for OMIKRON Basic
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429. 1.1             Turbo-Ass Introduction            7
  430.  
  431.  
  432.  
  433.  
  434.    PARALLEL : Special Transferformat for the Amiga
  435.    SMALLDRI : Produce DRI-Format (However without Import)
  436.    GFAINLINE: Produce GFA Inline Format
  437.    FSTANDARD: Set Fast-Load-Bit in Header (ST-Magazin 11/89) and
  438.  
  439.     Standard
  440.  
  441.  
  442. 2.10  Assembler Pseudo-Opcodes
  443.  
  444. DC,  DS,  BLK,    DCB,  EVEN,  ALIGN,  TEXT,  DATA,  BSS,  END,  =,  EQU,
  445. GLOBAL,  CNOP,    ORG,  ILLEGAL AND REG
  446.  
  447. DXSET Length[,Value] Define Table
  448. DX 'String' Fill Tableinput with the lenght
  449. RS,  RSRESET, RSSET, RSBSS Relative Segment
  450. OPT D+ Regular Symboltable on
  451. OPT X+ Enhanced Symboltable on
  452. OPT W+ Warnings on
  453. OPT P+ PC-relative program must be developed
  454. OPT O+ Optimization on
  455. With '-' the above can be turned off
  456. OUTPUT 'Filename' Default-Filename
  457. PATH   'Path' Set IBYTS for PATH
  458. IBYTES 'DEGAS.PI3',32000,34 Loads a Data File length 32000 from Byte 34
  459.     of the Data File (Here a Degas Picture)
  460. BASE    Much to complicated..
  461. REPT    Number, ENDR repeats the times between REPT and ENDR
  462. IF, ELSE, ENDC Limited Assembly
  463. FAIL    Abort Assembly 
  464.  
  465.  
  466. 3  The Debugger
  467.  
  468.  
  469. 3.1  Foreword
  470.  
  471. It is actually impossible to explain in short the Debugger that is 
  472. why you will find only the most important commands (Typing HELP in
  473. the Debugger Menu will have all commands summarized)
  474.  
  475.  
  476. 3.2  General
  477.  
  478. The Debugger does not use any I/O-Routines of TOS, thus it means that
  479. it is pretty save to say that it is quite immune to crashes. In Load
  480. Operations it will use GEMDOS calls.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490. 1.1             Turbo-Ass Introduction            8
  491.  
  492.  
  493.  
  494.  
  495. It run it own Monitorside, which avoids the "disturbing" of the Programm
  496. and the Debugger.
  497.  
  498. The Debugging can be accomplished through the use of the Mouse or the
  499. Keyboard.
  500.  
  501. The Debugger can be kept in memory, which on the User sides requires
  502. the copying into an AUTO-Folder or with the command RESIDENT. The
  503. Debugger can be called with CALL.PRG. You can also switch and access
  504. the Debugger through the Assembler (The Assembler can also load the
  505. Debuuger, see the Setting).
  506.  
  507.  
  508. 3.3  The Usage of the Debugger
  509.  
  510. The two upper lines correspond to the Functionkeys (with and without
  511. shift). The 3 following lines represent the Registerscontents and Flags.
  512. All parts of the 5 lines can be used with the help of the Mouse.
  513.  
  514. The rest (max. 20 lines) are modifyable. Here you'll have the 
  515. inputs and the outputs. Here the live goes wild.....
  516.  
  517. The Keyboard layout (Cursorkeys,  CTRL-M,  CTRL-1,  e.t.c.) is very
  518. similar to that of the Assembler.
  519.  
  520. Inputs are followed always from the beginnig of the line or after the
  521. Hex number. Empty character are ignort or used as spacers.
  522.  
  523. Upon loading of the Debugger through the Assembler the CTRL-HELP allows
  524. the jumping back. During the procedure the PC-Position is converted into
  525. the line number. This means that if a program crashed during Debbuging
  526. and the PC is in the program with the help of CTRL-HELP it is possible
  527. to jump to the appropriate part in the Source Code.
  528.  
  529. SHIFT-SHIFT allows the interuptioun of a running program. The 
  530. Ring-Indicator is also functioning. The Debugger is also reset-proof.
  531. Use as an Emergency brake is proven to be helpfull from time to time.
  532.  
  533.  
  534.    F1  - Executes the next command
  535.  
  536.    SF1 - Interrupts at the next Jump command. Simulates the Tracemode
  537.      of the 68020 Processor.
  538.  
  539.    F2  - Sets after the next command a Breakpoint and starts the 
  540.      program. This is very usefull to go through a Subprogram or
  541.      to complete a DBRA.
  542.  
  543.    SF2 - Not to important
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551. 1.1             Turbo-Ass Introduction            9
  552.  
  553.  
  554.  
  555.  
  556.    F3 -  Executes the program and interrupts after the RTS.
  557.      Attention! If with MOVEM values are saved in the Stack
  558.      => Bomb!
  559.  
  560.    SF3 - Identical to F3 but after RTE
  561.  
  562.    F4  - DOES NOT execute the next TRAP but jumps into it.
  563.  
  564.    SF4 - Start program without any Endconditions
  565.  
  566.    F5  - Next command is ignort, thus skip.
  567.  
  568.    SF5 - Toggle Insert/Overwrite
  569.  
  570.    F6  - Show Sourcecode (only if Bugaddo was entered through the 
  571.      Assembler)
  572.  
  573.    SF6 - Show converted Assembler markers
  574.  
  575.    F7  - Memorydump from the PC
  576.  
  577.    SF7 - Show Breakpoints
  578.  
  579.    F8  - Disassemble and Dump from the PC
  580.  
  581.    SF8 - Info about Memory contents
  582.  
  583.    F9  - List from PC (with Symbols if available)
  584.  
  585.    SF9 - Erase Screen, Warmboot
  586.  
  587.    F10 - Toggle Screen
  588.   
  589.    SF10- Quit Debugger 
  590.  
  591.  
  592. 3.4  The Commands
  593.  
  594. All commands can be abbreviated. 
  595.  
  596. ?Term  Calculates Term
  597. Term can (excluding comparisons) contain all operations of the 
  598. Assembler. Additional to that indirect Addressing is possible with
  599. {400}.l. ".l" is the range. All numbers are identified as HEX. Decimal
  600. numbers are shown with ".". In case of a Symboltable ".Symbolname" 
  601. allows the stepping-in.".
  602.  
  603. Defined Variables (partly)
  604. ^D0-^D7  Registers D0-D7
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612. 1.1             Trubo-Ass Introduction               10
  613.  
  614.  
  615.  
  616.  
  617. ^A0-^A7  Registers A0-A7
  618. PC, USP, SSP, SR, CCR, SP  Registers
  619. ^M0-^M9  Converted Assembler markers
  620.  
  621.  
  622. All of the above variables are modifieable with LET Variable=Term.
  623. LET can be abbreviated with "~".
  624.  
  625. A few more Read-Only-Variables:
  626. TEXT, DATA, BSS, START, END, BASEPAGE, BP, ACTPD, MEMBASE, SAVEAREA.
  627.  
  628. There are additional 20-30 not that important variables.
  629.  
  630. BREAKPOINT [Number=Address[,[*|=Value|number|?condition]|K]]
  631. Show, Delete, change and set the Breakpoints
  632.  
  633.  
  634.   Set B5=PC+.100 Breakpoint  5    (0-15 is possible) to Address PC+100
  635.  
  636.   B K  Delete all Breakpoints
  637.  
  638.   B    Show all Breakpoints
  639.  
  640.   BK3  Delete Breakpoint #3
  641.  
  642.  
  643.   B0=Adr, Number   : Set a Stop-Breakpoint with the number of times
  644.              executed. Following with the clearing of the 
  645.              Breakpoint. 
  646.  
  647.   B0=Adr,*       : Breakpoints are not deleted after execution. Normal
  648.              Breakpoints ARE delete.
  649.  
  650.   B0=Adr,=Wert       : Set counter to Adress of Adr. In ^BC0 it is counted
  651.              upwards to see how often the Address was reached.
  652.  
  653.   B0=Adr,?Term       : Causes BKPT, Interuption when Term<>0 example:
  654.              B0=Adr,?^D0=4711 => Interuption when PC=Adr 
  655.  
  656. GO [Adr]
  657. Start program from Adr or PC
  658.  
  659. TRACE
  660. Like F1
  661.  
  662. SHOWMEMORY Term
  663. Show 16 Bytes of(from) Term
  664.  
  665. UNTRACE [Adr]
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673. 1.1            Turbo-Ass Introduction               11
  674.  
  675.  
  676.  
  677.  
  678. Trace until the condition is fullfiled
  679.  
  680. IF Term
  681. Condition for UNTRACE
  682.  
  683. OBSERVE Trapno,Funkno
  684. Stop when Trapno(Function) is executed as an example:
  685. OBSERVE 14,8 => Stop when XBIOS(8) = Floprd()
  686.  
  687. CLS
  688. Clear 2. Screen
  689.  
  690. MOUSEON / MOUSEOFF
  691. VDI-Mouse on/off
  692.  
  693. |Instruction
  694. Execute Instruction (great for testing)
  695.  
  696. LEXECUTE "Filename"[,"Commandline"]
  697. Load relocatable program (=>Pexec()) then start with GO.
  698.  
  699. LOAD "Filename"[,Adress]
  700. Load File but does not relocate.
  701.  
  702. SAVE ["Filename"[,Address[,Endaddress]]]
  703. Save File
  704.  
  705. DIR "[Drive:][Path][Mask]"
  706. Example: DIR "D:\Assembler\*.SRC"
  707.  
  708. P Command (PRN)
  709. Example: Pd10000,10100" <= Disassembles a program from $10000 to $10100
  710. and prints it out on the printer.
  711.  
  712. FOPEN Filename, F command, FCLOSE
  713. Output of a command into a File
  714.  
  715. ERASE, KILL Filename
  716. Delete File (with wildcards!)
  717.  
  718. FREE 
  719. Show free memory
  720.  
  721. FREE Drive
  722. Shows amount of storage left on the Disk/Harddrive
  723.  
  724. MKDIRECTORY Name
  725. Create Folder
  726.  
  727. RMDIRECTORY Name
  728. Delete Folder
  729.  
  730. NAME oldname,newname
  731. Change Filename
  732.  
  733.  
  734. 1.1             Turbo-Ass Introduction               12
  735.  
  736.  
  737.  
  738.  
  739. FATTRIBUT Filename,attribut
  740. Change/set File-Attribut
  741.  
  742. FORMAT DS/SS,Drive
  743. Format Disk
  744.  
  745. TYPE Filename
  746. Display ASCII File (SPACE will pause the output)
  747.  
  748. READSECTOR Track,Sector,Side,Adress,Drive(0 or 1)
  749. Read Sector with XBIOS(8)
  750.  
  751. WRITESECTOR same as above
  752. Write Sector with XBIOS(9)
  753.  
  754. All of the following given commands allow the same Syntax as in the
  755. parameters thus only Parameters are represented. This means:
  756.  
  757. [Parameter] = [From][[,]#[Line]|,To|[,][Bytes[]]]
  758.  
  759. The setting of parameter is not necessarry. The Debugger takes the
  760. given values automatically.
  761.  
  762. If the expression "From" is missing the disassembling accours from
  763. the current address. The current Address is the number at the beginnning
  764. of the line, if however this is also missing the last used Address is
  765. recognized.
  766.  
  767. The End-Address ("To") must not be necessarilly put in. If a "#" is 
  768. entered instead of "To" a single line is put out. If "#" followed by
  769. a number thus is considered a Linenumber to output. It is possible
  770. to output 8 lines, however a max. of 99 are possible. If the End output
  771. is missing completely than (usually) only 16 lines are printed out. The
  772. number is changeable and can be modified with the Variable "Lines". The
  773. last option is the statement of the Bytenumber in square brackets. The 
  774. square brackets can be ignort.
  775.  
  776. Example:
  777. "d text #5"
  778. Disassembles 5 lines from the beginning of the loaded program.
  779.  
  780. Example:
  781. "m data[30]"
  782. Memorydump of the DATA-Segment (48 Bytes long).
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795. 1.1             Turbo-Ass Introduction               13
  796.  
  797.  
  798.  
  799.  
  800. Disassemble [Parameter]
  801. Disassemble with Dump, hoewever Dump can be changed!
  802.  
  803. List [Parameter]
  804. Disassemble with Symbols but without Dump, Opcodes can be changed (Don't
  805. forget the RETURN)
  806.  
  807. SYMBOLTABLE [Parameter]
  808. Display Symboltable
  809.  
  810. MEMORY[.B|.W|.L][Parameter]
  811. Memorydump with output width (changeable)
  812.  
  813. ASCII [Parameter]
  814. ASCII Dump (changeable
  815.  
  816. FIND [From,To], Terms{,Term}
  817. Search a loaded program or memory for Terms
  818.  
  819. HUNT (see above)
  820. Identical to Find however works on even Addresses
  821.  
  822. ASCFIND [From,To],String
  823. Search for a ASCII string (with wildcards) in the Disassembler listing.
  824. Slow but practical.
  825.  
  826. CONTINUE
  827. Continue Hunt, Find or ASCFIND when aborted through ESC
  828.  
  829. INFO
  830. Try it
  831.  
  832. SYSINFO
  833. Try this one out too
  834.  
  835. MOVE, COPY From, To, After
  836. Copy Memoryblock
  837.  
  838. FILL From, To, Term {,Term}
  839. Fill Memoryblock
  840.  
  841. CLR [From, To]
  842. Delete Memoryblock (or everything)
  843.  
  844.  
  845. COMPARE From, To, Adr
  846. Compare From, To area from Adr
  847.  
  848. EXIT, QUIT, SYSTEM
  849. Leave Debugger
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. 1.1             Turbo-Ass Introduction               14
  857.  
  858.  
  859.  
  860.  
  861. RESIDENT
  862. Keep Debugger Resident
  863.  
  864. SET, LET, ~
  865. See above
  866.  
  867. RESET ALL
  868. Coldboot Debugger
  869.  
  870. HELP
  871. Gives out all commands (as you'll see, a few more than described here)
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.             Table of contents
  882.  
  883.               Turbo-Assembler
  884.  
  885. 1 General    ..............................................    1
  886.    1.1 Introduction    ...................................    1
  887.    1.2 Turbo-Ass Features     .............................    1
  888.    1.3 What is Shareware?     .............................    2
  889.    1.4 Hardware requirements     ..........................    3
  890.    1.5 Installation    ....................................    3
  891.    1.6 About the Authors     ..............................    3
  892.    1.7 Copyright     ......................................    3
  893.  
  894. 2 The Assembler
  895.    2.1 User Guide to the Assembler     ....................    4
  896.    2.2 The Mouse in Turbo-Assembler    ...................    4
  897.    2.3 The Editor     .....................................    4
  898.    2.4 Special Features     ...............................    4
  899.    2.5 Optimization    ...................................    5
  900.    2.6 Formulas     .......................................    5
  901.    2.7 Keyboard Commands     ..............................    5
  902.    2.8 Editor Footnotes     ...............................    6
  903.    2.9 The Assembler     ..................................    6
  904.    2.10 Assembler Pseudo-Opcodes     ......................    7
  905.  
  906. 3 The Debugger       ........................................    7
  907.    3.1 Foreword     .......................................    7
  908.    3.2 General       ........................................    7
  909.    3.3 The Usage of the Debugger     ......................    8
  910.    3.4 The Commands    ...................................    9
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.       
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.              
  970.